docs: establish security, release, support, and governance readiness - #2
Open
CompleteDotTech wants to merge 1 commit into
Open
Conversation
Add the security, support, release, and governance surfaces required to publish and maintain Psyche as a protocol other repositories rely on: - SECURITY.md: supported versions/surfaces, the private vulnerability reporting route, disclosure expectations, and the ordinary-support boundary. - SUPPORT.md: public support routes and the reporting contract that keeps secrets, raw prompts, environment dumps, private repository data, and full personal paths out of public issues. - .github/CODEOWNERS: protected review for core contracts, store and its migrations, the Coven boundary, surfaces, conformance, evidence, CI, release, and docs. - .github/PULL_REQUEST_TEMPLATE.md: scope, risk, contract impact, migration, rollback, generated artifacts, tests, and affected consumers. - .github/ISSUE_TEMPLATE: guarded defect and contract/conformance forms (blank issues disabled) that never solicit protected data. - docs/GOVERNANCE.md: the ownership map, branch/ruleset policy binding required checks and review for maintainers and administrators, the named/time-bounded/auditable emergency bypass with restoration and review, and the current dependency-review, secret-scanning, and provenance controls aligned with cargo-deny and gitleaks. - docs/RELEASE.md: the release contract - artifact types and channels, versioning for schema/profile, Rust implementation, npm wrapper, and conformance runner, immutable release metadata with SBOM, provenance, and signed digests, packed-artifact verification from a clean install, RC/stable/deprecation/emergency/rollback stages, support windows, the compatibility matrix with downstream canary evidence, and the release rehearsal checklist. Docs-only diff. Every documented behavior is verified against current source (forward-only store migrations, fail-closed checksum placeholders, CI check names, cargo-deny and gitleaks invocations, pack allowlist). Refs OpenCoven#14. Signed-off-by: Timothy Wayne Gregg <5861166+CompleteDotTech@users.noreply.github.com>
CompleteDotTech
marked this pull request as ready for review
August 30, 2026 15:54
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Establishes the security, support, release, and governance readiness surfaces required to publish and maintain Psyche as a protocol relied on by multiple OpenCoven repositories. This is a docs-only change: nine new files, no code, no workflow, no behavior change. Every documented control distinguishes what is current today (cargo-deny, gitleaks, fail-closed wrapper checksums, forward-only migrations) from what is applied at settings time or first exercised at the release rehearsal, so readiness can be verified rather than claimed from file presence.
SECURITY.md— supported versions/surfaces (main-branch builds only; npm unpublished, gated at G12), private vulnerability reporting route, disclosure expectations (ack ≤5 business days, updates every 14 days, coordinated disclosure ≤90 days), and the ordinary-support boundary.SUPPORT.md— public support routes and the reporting contract that keeps secrets, raw prompts, unrestricted terminal output, private repository data, environment dumps, and full personal paths out of public issues..github/CODEOWNERS— protected review for core contracts, store/migrations, Coven boundary, surfaces, conformance, evidence, CI, release, and docs, with the reasoning documented indocs/GOVERNANCE.md..github/PULL_REQUEST_TEMPLATE.md— scope, risk, contract impact, migration, rollback, generated artifacts, tests, and affected consumers..github/ISSUE_TEMPLATE/— guarded defect and contract/conformance forms; blank issues disabled because unstructured intake is where protected data leaks.docs/GOVERNANCE.md— ownership map, branch/ruleset policy (required checks and review applying to maintainers and administrators, no silent bypass), named/time-bounded/auditable emergency changes with restoration and review, and the current dependency-review/secret-scanning/provenance controls aligned with the existing cargo-deny and gitleaks checks.docs/RELEASE.md— the release contract: artifact types and the single npm distribution channel, versioning for protocol schema/profile, Rust implementation, npm wrapper, and conformance runner, immutable release metadata (SBOM, provenance, signed digests), packed-artifact verification from a clean install rather than source-relative imports, RC/stable/deprecation/emergency-patch/rollback procedures, support windows and upgrade/downgrade policy (downgrade fails closed onUnsupportedDatabaseVersion), the compatibility matrix with downstream canary evidence, and the one-rehearsal checklist.Scope
Docs and governance surfaces only: root community-health files,
.github/templates and CODEOWNERS, anddocs/. No crate, package, workflow, or script is touched.Risk
Low: no executable code changes. The main risk is a policy statement that overclaims — every current-state claim is verified against source in this commit (
Store::openversion refusal, placeholder digest tests, CI check names,deny.tomlchecks, pack allowlist), and aspirational controls are labeled as such rather than presented as active.Contract impact
None — the closed v1 registry, error codes, digest computation, and record identity are untouched.
Migration
None — the store schema is untouched;
001_foundation.sqlandmigrations.rsare unreferenced beyond documenting their existing forward-only behavior.Rollback
Revert the commit. The files are additive documentation; no data, artifact, or setting is created by this change.
Generated artifacts
None — no fixtures, digests, manifests, or tarballs are generated.
Tests
js-yamlparse; unique field ids)npm --prefix packages/psyche-npm test— 16 pass, 0 fail (repo health; unrelated to the diff)cargo fmt/cargo clippy/cargo test— deferred to CI (no Rust toolchain in the authoring environment; the diff contains no Rust)Affected consumers
None directly. Downstream consumers (coven, adapters) gain documented ownership, reporting, and release-support contracts to bind against once the ruleset is applied.
Issue
Refs OpenCoven#14